home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer)…68k, x86, SPARC, PA-RISC] / NeXTSTEP 3.3 Dev Intel.iso / usr / sybase / doc / dbiowdesc.man < prev    next >
Text File  |  1993-04-22  |  3KB  |  89 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89 DBIOWDESC    (UNIX only)
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  DBIOWDESC    (UNIX only)
  6.  
  7.   FUNCTION:
  8.        Provide program access to the UNIX  file  descriptor  used  by  a
  9.        DBPROCESS to write data to SQL Server.
  10.  
  11.   SYNTAX:
  12.        int DBIOWDESC(dbproc)
  13.  
  14.        DBPROCESS *dbproc;
  15.  
  16.   COMMENTS:
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   DBIOWDESC    (UNIX only)Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.        o This routine provides a way for an application  to  effectively
  28.          utilize  multiple  input  and output streams.  Depending on the
  29.          nature of your application, the time interval between the  ini-
  30.          tiation  of an attempt to write information to SQL Server (usu-
  31.          ally made via a call to dbsqlsend()) and the completion of that
  32.          attempt  may  be significant.  You may use this time to service
  33.          other parts of your application. The DBIOWDESC()  routine  pro-
  34.          vides a way to obtain the I/O descriptor which a DBPROCESS uses
  35.          to write the data stream to SQL Server.  This  information  may
  36.          then  be used with various operating system facilities (such as
  37.          the UNIX select() function) to allow the application to  effec-
  38.          tively utilize multiple input and output streams.
  39.        o The file descriptor returned by this routine may only  be  used
  40.          with  operating system facilities that do not write data to the
  41.          outgoing data stream. If data is written to this stream by  any
  42.          means  other  than through a DB-Library routine, communications
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89 DBIOWDESC    (UNIX only)
  47.   ______________________________________________________________________
  48.          between the front-end and  SQL Server  will  become  hopelessly
  49.          scrambled.
  50.  
  51.        o A companion routine, DBIORDESC(), provides access to  the  file
  52.          descriptor used to read data coming from SQL Server.
  53.        o For an example that illustrates the  use  of  DBIOWDESC()  with
  54.          dbsqlsend() and dbsqlok(), see the DB-Library Reference Supple-
  55.          ment.
  56.  
  57.   PARAMETERS:
  58.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  59.            connection for a particular front-end/SQL Server process.  It
  60.            contains all the information that DB-Library uses  to  manage
  61.            communications and data between the front end and SQL Server.
  62.  
  63.   RETURNS:
  64.        An integer file descriptor used by  the  specified  DBPROCESS  to
  65.  
  66.  
  67.  
  68.   DBIOWDESC    (UNIX only)Version 4.0 -- 5/1/89                        4
  69.   ______________________________________________________________________
  70.        write data to SQL Server.
  71.  
  72.   SEE ALSO:
  73.        dbcmd, DBIORDESC, dbnextrow, dbresults, dbsqlok, dbsqlsend
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.